home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1998 September / Macworld (1998-09).dmg / Shareware World / Info / For Developers / Script-Daemon-101 / Documentation next >
Text File  |  1995-02-25  |  5KB  |  102 lines
  1. Script Daemon v1.0.1 © 1993-95 Peter N Lewis.
  2. This program is free for any use.
  3.  
  4. Contents
  5.  
  6.       What Script Daemon Does
  7.       What is Script Daemon
  8.       Using Script Daemon
  9.       Limitations
  10.       Small Print
  11.       Warranty
  12.       Fine Print
  13.       How It Works
  14.       Version History
  15.       Acknowledgements
  16.       The Author
  17.  
  18. What Script Daemon Does
  19.  
  20. Script Daemon allows you to telnet to your Mac and enter AppleScript commands.  Only the owner can log in (using the Owner name&password).
  21.  
  22. It currently assumes and relies on AppleScript English.  Sorry.  If you don’t like this, let me know.
  23.  
  24. Note: This release is a bit rough.  I don’t know how this will be used, so I’m basically releasing it to let you tell me what you want.
  25.  
  26. Using Script Daemon
  27.  
  28. Put the Users and Groups in the Scripting Additions folder, and put an alias to Script Daemon into the Startup Items folder and launch it.  Now telnet to your mac, log in using the owner name and owner password, and type AppleScript commands.  Script Daemon itself accepts certain (non-AppleScript) commands, these commands start with a slash (/).  The following commands are implemented:
  29.  
  30. /HELP - list the commands.
  31. /EXEC - enter a multi-line AppleScript script.  Terminate the script by typing a period (.) on a line by itself.  Currently there is no way of aborting a script.
  32. /QUIT - close the connection and quit.
  33.  
  34. Lines not starting with a slash are passed through to AppleScript.  Note that a line "quit" means the AppleScript command "quit" which by default quits the current application, namely Script Daemon - since this is usually not what you want to do, I disallow it, type "<space>quit" if you really mean it.
  35.  
  36. Note that the context information is preserved permanently.  That is, you can type AppleScript commands like:
  37.  
  38. set test to "fred"
  39.  
  40. And then quit Script Daemon and relaunch it, and then type:
  41.  
  42. test
  43.  
  44. And it will display "fred".
  45.  
  46. Limitations
  47.  
  48. Script Daemon requires MacTCP 1.1, System 7, and AppleScript.  
  49.  
  50. Script Daemon will work with AppleShare 3, but its a bit of a hack.  The problem is that to do any operation on the U&G file under ASFS you need to pass in the admin key.  The osax lets you do this by supplying an optional parameter.  Drop the osax on to the Script Editor to see the syntax.  Script Daemon authenticates the user by executing string 5 from the STR# 128 resource.  This looks like this...
  51.  
  52.   authenticate user name "^1" password "^2"
  53.  
  54. If you bash this (using ResEdit) to this...
  55.  
  56.   authenticate user admin «your_admin_key» name "^1" password "^2"
  57.  
  58. it should work under ASFS. [Replace «your_admin_key» with a string
  59. containing the admin key for your ASFS.]
  60.  
  61. Security Warning: Your copy of Script Daemon now has a plain text copy of your admin password, so keep it very secure.
  62.  
  63. Small Print
  64.  
  65. This program is Free.  You can use it anywhere you want, you can do anything you like with it.
  66.  
  67. Warranty
  68.  
  69. While I have made every attempt at making this program work correctly, I cannot guarantee it will work.  If it doesn’t work, I’ll refund your money :-)
  70.  
  71. The Users and Groups addition is from Quinn at the University of Western Australia’s Computer Science department.  It is available seperately, and is included with this package for your convenience.
  72.  
  73. Fine Print
  74.  
  75. Peter Lewis hereby disclaims all warranties relating to this software, whether express or implied, including without limitation any implied warranties of merchantability or fitness for a particular purpose.  Peter Lewis will not be liable for any special, incidental, consequential, indirect or similar damages due to loss of data or any other reason, even if Peter Lewis or an agent of his has been advised of the possibility of such damages.  In no event shall Peter Lewis be liable for any damages, regardless of the form of the claim.  The person using the software bears all risk as to the quality and performance of the software.
  76.  
  77. How It Works
  78.  
  79. Script Daemon listens to port 23 (the telnet port), accepts logins, validates them using the Users and Groups AppleScript extension (thanks to Comp Sci at UWA!), and then compiles and executes scripts.  The external interface uses the ISO-8859-1 character set.
  80.  
  81. Version History
  82.  
  83. Still to do -
  84.  
  85. Some way of allowing more than just the owner to connect, perhaps a File Sharing group?
  86. Some way of allowing people to connect but not run arbitrary AppleScript commands, perhaps feed their commands to some handler you define?
  87. Some way to abort a /exec script
  88. .login script?
  89.  
  90. 1.0.1
  91. ~Scan the <relevant> folder and find the U&G file and pass its name to the authenticate call.
  92.  
  93. 1.0.0
  94.  
  95. Acknowledgements
  96.  
  97. A huge thank you goes to Quinn and UWA’s Computer Science department for making the Users & Groups AppleScript extension available and allowing me to bundle it with Script Daemon.
  98.  
  99. And another thank you goes to Onno Benschop for the icons.
  100.  
  101. And another to Quinn for lots of ideas, and to Stuart Cheshire for lots of other ideas.
  102.